home *** CD-ROM | disk | FTP | other *** search
/ QuickTime for the Web (2nd Edition) / QuickTime for the Web (2nd Edition).iso / pc / Tools / Mac / MakeCubic / MakeCubicPPC_ReadMe next >
Encoding:
Text File  |  2001-09-10  |  14.8 KB  |  340 lines

  1. ################################################################
  2. #
  3. #    File:        MakeCubicPPC_ReadMe
  4. #
  5. #    Contains:    Simple Instructions to use MakeCubicPPC
  6. #
  7. #    Written by:    Ken Turkowski, Eric Blanpied
  8. #
  9. #    Copyright:    © 2000-2001 Apple Computer, Inc.
  10. #
  11. #    To Do:
  12. #                Pictures? HTML? Movies?
  13. #
  14. ################################################################
  15.  
  16.  
  17. MakeCubicPPC is a simple app for creating cubic QTVR movies from six faces
  18. or from equirectangular spherical images.
  19.  
  20. It's especially handy after retouching faces exported from a stitcher,
  21. or for making cubic panos from 3D generated imagery. It also can convert
  22. equirectangular images to cubic panos.
  23.  
  24. You can also drop an already made 6-frame cubic vr movie. The app will
  25. then use the existing compressed data in the file and let you set
  26. new angles, etc.
  27.  
  28.  
  29. Source Files
  30. ____________
  31. You can give MakeCubicPPC either:
  32. - single equirectangular spherical images
  33. - six cubic face images
  34. - single movie with six frames
  35. You can also supply a fast start preview or hot spots in the same type of
  36. files (i.e. equirectangular, face picts, face movie) as the main panorama.
  37.  
  38. An equirectangular spherical image is a map of the surrounding environment
  39. sampled equally in latitude and longitude. The north pole is stretched
  40. into a line on the top, and the south pole is stretched into a line on
  41. the bottom, with the equator undistorted in the middle.
  42.  
  43. A cube has six faces. If you choose to supply cubic faces to MakeCubicPPC,
  44. either in the form of a set of six image files or a single movie file with
  45. six frames, they should be ordered (numbered) in the following order:
  46. front, right, back, left, top, bottom, with the top and bottom rotated
  47. 90° from the front view.
  48.  
  49.  
  50. Using MakeCubicPPC
  51. __________________
  52. Launch the application, then select Convert (cmd-O) from the file menu.
  53. Set the appropriate parameters, then click OK. Then select an output
  54. file name, and the QuickTime VR file will be produced. 
  55.  
  56. Alternatively, drag a set of files onto the MakeCubicPPC application.
  57. This is the faceless applet mode, where a cubic QuickTime VR movie
  58. is produced automatically using default parameters. The only dialog
  59. that occurs is one where the automatically-generated output file name
  60. clashes with an already existing file. It looks for a common root for
  61. the file names, and looks for "FS" or "HS" after that to distinguish
  62. a regular panborama file from a fast start or hot spot file respectively.
  63. The default output filename is the root file name with a ".mov" or "..mov"
  64. suffix.
  65.  
  66.  
  67. Parameters
  68. __________
  69. Main source file - It is required to select a main source file(s) for
  70. each panorama to be created. You can optionally select the compression
  71. codec and quality (defaults to Photo JPEG at 50% quality).
  72.  
  73. Fast Start Preview - If a fast start preview is desired (this is recommended),
  74. make sure the box is checked. You can either select a preview file(s)
  75. or have MakeCubicPPC make a preview for you. Unfortunately, you cannot
  76. choose the compression fast start codec and quality at this time, despite
  77. the button in the dialog - Photo - JPEG at 25% quality is always used.
  78. If you choose to have MakeCubicPPC generate a preview for you, you can
  79. choose its resolution, whether it is to be blurred, and whether it is
  80. to be gray or color. The resolution is specified in terms of pixels per
  81. degree (0.5-1.0 are good starting values, with or without blurring).
  82.  
  83. Hotspot - You can select a hot spot file(s) if desired.
  84.  
  85. Min/Max/Default Pan/Tilt/FOV - You can set the limits of pan, tilt, and
  86. FOV, as well as the default values that are used when the panorama is opened.
  87. If you check the "Optimal FOV for Window Size" checkbox, MakeCubicPPC
  88. will set the default FOV to give you 1:1 pixel zooming (i.e. if you zoom
  89. in from this point, you will see pixelization, and if you zoom out, you
  90. will get aliasing), and the minimum FOV to give you 2:1 pixel zooming.
  91. The maximum FOV is not affected by this checkbox. If you subsequently change
  92. the minimum or default FOV, the optimal checkbox will be unchecked.
  93.  
  94. Window Width and Height - The dimensions of the playback window can be set.
  95.  
  96. Tiling Width and Height - This allows you to specify the number of tiles
  97. to produce per face in width and height (these may be different). The default
  98. is 1 tile per face. However, it may be advantageous to subtile each face
  99. when the panorama resolution is high. If you check the "Auto-Tile" checkbox,
  100. MakeCubicPPC will try to produce tiles about 400x400 pixels. WARNING: There
  101. is a bug in the 5.0.1 QuickTime VR for Windows extension where evenly
  102. tiled faces (i.e. 2x2, 4x4, etc.) sometimes will produce a memory fault,
  103. so it is suggested to use odd tiling (1x1, 3x3, etc.) for the time being.
  104.  
  105. Motion and Static Quality - You can set the quality of rendering while
  106. panning (motion quality) and when the mouse is released (static quality).
  107. The only values enabled are Normal (50%) and High (75%). The Better (62%)
  108. quality is only available for cylindrical panoramas, and the Low (25%)
  109. quality was only available in the original cylindrical QuickTime VR.
  110. The defaults are to use normal quality during panning (motion), and high
  111. quality when stopped (static).
  112.  
  113.  
  114. Preferences
  115. _________
  116. Under the File menu, you can choose the Preferences menu to tailor MakeCubicPPC's
  117. defaults to be those that you like.
  118.  
  119. When you change the prefererences, you have the option to have it remain valid
  120. only for the current session, or it can be saved to a file, so the preferences will
  121. be reatined between sessions. The preferences file is called "MakeCubic Preferences",
  122. and can be found in the Preferences folder of the System Folder, or in the same folder
  123. where MakeCubicPPC resides. The default location is the Preferences folder, but
  124. if there is also one in the MakeCubicPPC folder, that is the one that takes
  125. precedence. The file is human-readable XML, though the type is 'pref' rather
  126. than 'TEXT'.
  127.  
  128. • Equirectangular rotation - If an equirectangular image is taller than it is wide,
  129.   it will be rotated 90° clockwise or counterclockwise, depending on how this
  130.   option is set.
  131. • Panorama compression - The default settings for the compression of the
  132.   high resolution panorama are set here. The default is 24 bit JPEG at 50% quality.
  133. • Preview compression - The default settings for the compression of the
  134.   low resolution preview are set here. The default is 24 bit JPEG at 25% quality.
  135. • Preview options - Here you have the choice as to whether the preview is made
  136.   automatically, and whether it should be grayscale or blurred.
  137. • Preview resolution - This is specified in units of pixels per degree, i.e. 1 pixel
  138.   per degree implies 360 pixels around the circumference. A useful range is
  139.   0.5 - 2.0 (note that the resolution can be fractional).
  140. • Minimum/Default/Maximum FOV - These are the values that are used when the
  141.   "Optimal FOV" checkbox is not checked. The maximum FOV is used in either
  142.   case.
  143. • Optimal FOV - When this is checked, the FOV is computed to yield the specified
  144.   zoom factor of the pixels. The default is to have 2:1 pixel zooming at the minimum
  145.   FOV, and 1:1 pixel zooming at the default FOV.
  146. • Initialize Parameters from QuickTime VR Movie - You can choose an existing
  147.   QuickTime VR movie as the input to MakeCubicPPC. If you have this checkbox
  148.   checked, then the values in the dialog are initialized from the QuickTime VR movie.
  149.   The pan, tilt, FOV and window dimension are affected by this option.
  150.   This is especially useful when you are just adding or changing the preview. Since
  151.   the QTVR movie is not degraded by repeated compression, you can tweak your
  152.   movie as much as you want.
  153. • Window Width and Height - Just set your favorite window size in the Preferences
  154.   dialog, and you'll never have to set it again.
  155. • Tiling Width and Height - You can set the preferred tiling of each face. The default is 1x1.
  156. • Auto-tile - When this checkbox is checked, MakeCubicPPC attempts to make each tile
  157.   close to the target dimension. The default is to *not* auto-tile. The default target
  158.   dimension is 400. This means that an 800x800 face will be tiled 2x2, a 599x599
  159.   face will be tiled 1x1, and a 602x602 face will be tiled 2x2.
  160. • Quality - the rendering quality during panning ("motion") and when stopped ("static")
  161.   can be chosen from the pop-up menus. Only "Normal" and "High" are choosable; the
  162.   others are of historical interest only. 
  163.  
  164. If you Cancel out of the Preferences dialog, none of your changes will be saved.
  165.  
  166. If you choose the "This Session Only" button, then your preferences will remain in
  167. effect as long as MakeCubicPPC is running.
  168.  
  169. If you choose "Save Preferences", then your preferences will be saved in a file, so
  170. that every subsequent use of MakeCubicPPC will use these preferences.
  171.  
  172.  
  173. What's Going On Under the Hood (Technical - may be glossed over)
  174. ________________________________________________________________
  175. If you choose movies as the source files, with 1x1 tiling, then the tracks
  176. are copied verbatim from the sources to the output file, thereby resulting
  177. in no image degradation. In this case the compression parameters are
  178. ignored. However, the movie frames may be recompressed under certain
  179. conditions:
  180. (a) if you choose to subtile the faces, or
  181. No longer is there double compression if you choose to create a fast start preview.
  182. There will likely be more degradation due to subtiling and recompression
  183. of movie faces, because they may need to be scaled in order to fit the
  184. tiling scheme, and the compression block boundaries will shift.
  185.  
  186. If your sources are picture files, then the images will degrade based
  187. upon your selection of compression parameters. It is better to start
  188. out with source images that are only slightly compressed, in order to
  189. avoid double-compression artifacts.
  190.  
  191. The edges of each of the tiles are duplicated in adjacent tiles, in order
  192. to facilitate interpolation. This means that subtiling without resizing
  193. implies that (D-1) is divisible by N, where D is the linear dimension of
  194. a face, and N is the number if tiles, instead of the more intuitive
  195. D divisible by N.
  196.  
  197. If your source image is an equirectangular spherical image, then the
  198. cube faces are generated with the same focal length
  199. (see http://www.worldserver.com/turk/quicktimevr/panores.html).
  200.  
  201. The graphics codec is always used at maximum quality for compressing the 
  202. hot spots.
  203.  
  204. Any files can be chosen in the dialog. However, if a file has a decimal
  205. number contained within it, MakeCubicPPC will look for other files
  206. that are similar except for the number, assuming that you want to
  207. choose a sequence of images. If this causes problems, either move
  208. the files to a diffeent directory, or rename them to avoid unwanted
  209. sequences.
  210.  
  211. The following file name sets can be parsed correctly, when files are
  212. dragged onto MakeCubicPPC (where %d stands for a decimal number):
  213.     name%d.ext, nameHS%d.ext, nameFS%d.ext
  214.     name%d.ext, name%dHS.ext, name%dFS.ext
  215.     %d.ext,     HS%d.ext,     FS%d.ext
  216.     %d.ext,     %dHS.ext,     %dFS.ext
  217.     name.ext,   nameHS.ext,   nameFS.ext
  218.     name%d,     nameHS%d,     nameFS%d
  219.     name%d,     name%dHS,     name%dFS
  220.     name,       nameHS,       nameFS
  221.     %d,         HS%d,         FS%d
  222.     %d,         %dHS,         %dFS
  223. The extensions may be different for the different file types
  224. (e.g. pano.jpg, panoHS.png, panoFS.pct), but should be the same
  225. for a sequence of the same type (i.e. NOT face1.jpg, face2.gif).
  226.  
  227. Hot spots are given the name "Hot Spot #ddd", where ddd is the hot spot
  228. number. You have no choice. This is displayed in the status box when
  229. you mouseover a hot spot.
  230.  
  231. Only undefined type hot spots are ever created, never URL type hot spots.
  232.  
  233. You must have all six hot spot files or frames, even if some are just all 
  234. white files (ie no hot spots on that face). This doesn't apply (obviously)
  235. to equirectangular spherical pictures.
  236.  
  237.  
  238. Examples
  239. ________
  240.  
  241.  
  242. To Do
  243. _____
  244. • When reading a cubic panorama, transfer the hot spot track. This allows you to
  245.   tweak an existing panorama.
  246. • Possibly allow choice of hot spot compression, as long as it is lossless.
  247. • Provide some mechanism to assign hot spot names.
  248. • Provide some mechanism to assign URL's to hot spots.
  249. • Store preferences in a file, so that the droplet uses the preferred
  250. parameters.
  251.  
  252.  
  253. ________________________________________________________________
  254.  
  255. MakeCubicPPC Revision History:
  256.  
  257. 1.1.1a2
  258. -------
  259. • Use Appearance manager to get "nice" progress bars, especially on OS X.
  260.  
  261. 1.1.1a1
  262. -------
  263. • OS X.
  264.  
  265. 1.1.1d1
  266. -------
  267. • Implement batch addition of a preview track, when dragging several QuickTime VR panorama
  268.   movie files onto MakeCubicPPC. Hot spot tracks are not preserved, but view parameters are.
  269.  
  270. 1.1.1d0
  271. -------
  272. • Preferences!
  273.  
  274. 1.1.0d6
  275. -------
  276. • Fix bug with corner averaging when making previews.
  277. • Fix "Terry bug", where source is a QTVR cubic movie where the tracks have been scaled.
  278.  
  279. 1.1.0d5
  280. -------
  281. • Fix bug introduced in 1.1.0d4 where a standard QuickTime movie would have a null window size.
  282.  
  283. 1.1.0d4
  284. -------
  285. • Use Navigation Services instead of the standard file dialog. This should allow it to work on OS X.
  286.   Explicitly select the files to be used (with shift-select) in the navigation dialog. This should work
  287.   as long as the files have the correct type; it probably won't work if file.jpg is set to type TEXT.
  288. • Display more explicit file names in the dialog, parsing for common structure, e.g.
  289.   MyPanoFace{1,2,3,4,5,6}.jpg as a shorthand for
  290.   {MyPanoFace1.jpg,MyPanoFace2.jpg,MyPanoFace3.jpg,MyPanoFace4.jpg,MyPanoFace5.jpg,MyPanoFace6.jpg}.
  291. • Remember display settings when inputting a QTVR cubic movie. Specifically, it will remember
  292.   {min,max,def}{pan,tilt,fov} and window{width,height}.
  293. • Allow choice of fast start compression.
  294.  
  295. 1.1.0d3
  296. -------
  297. • Don't recompress movies if not changing the tiling nature. This then makes
  298.   it useful for adding previews to already existing movies, or for changing the
  299.   view parameters.
  300.  
  301. 1.1.0d2
  302. -------
  303. • Make preview when using a movie as a source.
  304.  
  305. 1.1.0d1
  306. -------
  307. • New UI.
  308. • Gray preview option.
  309. • Present real codec names.
  310. • Use VRMakePano.c to generate the output.
  311. • Add dialogs for unusual situations.
  312. • Option to tile faces.
  313. • Create the preview internally, rather than relying on the flattener
  314.   in the QtuckTime VR Authoring extension.
  315.  
  316. 1.0.3d1
  317. -------
  318. • Force hot spot GWorld to be eight bits even if the hot spot images provided have a
  319.   greater depth - allows the FindHotSpots routine to find the proper hot spot IDs.
  320.  
  321. 1.0.2d1
  322. ---------
  323. • Properly create 8-bit hot spot faces from equirectangular; this bug was
  324.    a side-effect of the "8 bit GWorld" feature from 1.0.1d1.
  325.  
  326. 1.0.1d1
  327. ---------
  328. • Add QTAtoms for hot spots; this allows assignment in HTML,
  329.    wired sprites, etc.
  330. • Create 8 bit GWorld when images are 8 bits.
  331. • Robustly take care of unexplained failures with FlattenMovie, to
  332.    guarantee that a file is written.
  333. • Pop up an info window during compression, to notify which stage it is in.
  334. • Use the name of applet to determine which way the equirectangular
  335.    source is rotated if it is taller than wide, e.g
  336.    MakeCubicPPC.CW   takes a              clockwise rotated equirectangular
  337.    MakeCubicPPC.CCW takes a counter-clockwise rotated equirectangular
  338.  
  339.  
  340.